﻿<HTML>
  <HEAD>
    <META http-equiv="Content-Type" content="text/html; charset=utf-8">
    <TITLE>Implementing a property page for an ArcGIS Engine application</TITLE>
    <LINK REL="stylesheet" TYPE="text/css" HREF="http://help.arcgis.com/en/sdk/10.0/common/style/esri_sdk_web.css">
  </HEAD>
  <BODY topmargin="0" id="bodyID" class="dtBODY">
    <div class="sdk_topic">
      <div id="nsbanner" esri_sdk_guid="b55055ea-2c2e-473f-922c-7a2ad9ade191" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
        <div id="TitleRow" class="bannertitle">
          <table class="titleWithBackground">
            <td>
              <H1>Implementing a property page for an ArcGIS Engine application<a name="ICallout"></a></H1>
            </td>
          </table>
        </div>
      </div><br xmlns:MSHelp="http://msdn.microsoft.com/mshelp"><div class="main">
        <fieldset class="Property" style="width: auto" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
          <legend class="PropertyName">Purpose</legend><span class="PropertyValue"><purpose>
    <div xmlns="http://www.w3.org/1999/xhtml">This sample demonstrates a mechanism to implement PropertyPages for ArcGIS Engine applications.</div>
    <div xmlns="http://www.w3.org/1999/xhtml">This sample contains an implementation of a PropertySheet and a PropertyPage. The object whose properties are controlled by the PropertyPage is any feature layer loaded into the MapControl application. The PropertyPage uses the SymbologyControl to display the marker, line, and fill symbols, which are used to update the symbol used by the renderer of the feature layer. The sample uses the SymbologyControl in conjunction with the MapControl, TOCControl, ToolbarControl, and the control commands. </div>
    <div xmlns="http://www.w3.org/1999/xhtml">The following issues are addressed in this sample:</div>
    <ul style="" type="disc" xmlns="http://www.w3.org/1999/xhtml">
      <li>Creating a PropertySheet and PropertyPage</li>
      <li>Registering a PropertyPage to a PropertySheet</li>
      <li>Connecting an object with its PropertySheet</li>
      <li>Instantiating and launching a PropertySheet</li>
      <li>Querying a FeatureRenderer's symbology</li>
      <li>Loading the StyleFile into the SymbologyControl</li>
      <li>Getting a selected symbol from the SymbologyControl</li>
      <li>Applying a new symbol to a FeatureRenderer </li>
    </ul>
  </purpose></span></fieldset><br xmlns:MSHelp="http://msdn.microsoft.com/mshelp"><h4>How to use</h4>
        <p>See 
        <a href="http://help.arcgis.com/en/sdk/10.1/arcobjects_net/conceptualhelp/index.html#/how_to_use_arcgis_samples/0001000001w2000000/">How to use ArcGIS samples</a>
        for help running the sample.</p>
        <ol>
          <li>Start Visual Studio, open the solution, and build the project.</li>
          <li>Run the MapControl application.</li>
          <li>Add any FeatureLayer with a simple renderer to the map.</li>
          <li>Right-click the FeatureLayer in the table of contents to open the context menu with the FeatureLayer symbol properties command.</li>
          <li>Select the FeatureLayer symbol properties command to open the PropertySheet.</li>
          <li>Select the desired symbol and click Apply to apply the new symbol to the layer.</li><br></ol><br><br><hr tabIndex="-1" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"><br xmlns:MSHelp="http://msdn.microsoft.com/mshelp"><fieldset class="Property" style="width: auto" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
          <legend class="PropertyName">Additional Requirements</legend><span class="PropertyValue"><ul>
              <li>This sample uses the PropertyPages.dll assembly, which was written by Robert Simpson. For more information see http://www.codeguru.com/cpp/controls/propertysheet/propertysheetbuttons/article.php/c8545.</li>
            </ul></span></fieldset><br xmlns:MSHelp="http://msdn.microsoft.com/mshelp"><table class="dtTable" cellspacing="0" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
          <tr>
            <th>Development licensing</th>
            <th>Deployment licensing</th>
          </tr>
          <tr style="empty-cells:show">
            <td>Engine Developer Kit</td>
            <td>Engine</td>
          </tr>
        </table><br xmlns:MSHelp="http://msdn.microsoft.com/mshelp"><br><br></div>
    </div>
  </BODY>
</HTML>